Window Captions
The captions of the various windows that comprise the Dyalog Integrated Development Environment (IDE) are user-configurable and defined by entries in the Windows registry in the Captions subkey of the main Dyalog key.
Note that this only applies when the windows are floating (un-docked). When a window is docked Dyalog displays a fixed non-configurable caption.
Note also that the Captions subkey is not created by the interpreter; the user must create the subkey and the values.
Each entry is a string value whose name identifies the window as follows:
Window Name | Description |
---|---|
Session | The main Dyalog APL session window |
Editor | The Editor window |
SysTray | The hint on Dyalog icons in the System Tray |
MessageBox | The notification Message Box that is displayed in various circumstances; for example, when an object cannot be fixed by the Editor |
Explorer | The Workspace Explorer tool |
Rebuild Errors | The dialog box that is displayed if one or more objects cannot be re-instantiated when a workspace is loaded |
Status | The Status window |
Event Viewer | The Event Viewer |
FindReplace | The Find/Replace dialog box |
ExitDialog | The Exit dialog box that is displayed when the user closes the Session window |
WSSearch | The Find Objects tool |
Syserror | The Syserror Message Box |
Each string value should contain a mixture of your own text and keywords which are enclosed in braces, for example, {TITLE}. Keywords act like variables and are replaced at display time by corresponding values as described in the table below.
Keyword | Value |
---|---|
{TITLE} | The window name shown in the first column of the previous table |
{WSID} | Workspace ID (⎕WSID) |
{NSID} | Current Namespace |
{SNSID} | Current Namespace (short version) |
{PRODUCT} | The name of the Dyalog product, for example, "Dyalog APL/W - 64" |
{VER_A} | The main version number, for example, "14" |
{VER_B} | The secondary version number, for example, "0" |
{VER_C} | The tertiary version number (currently the internal revision number) |
{PID} | The process ID |
{CHARS} | "Classic" or "Unicode" |
{BITS} | "32" or "64" |
{XLOC} | The namespace currently being explored (Explorer only) |
For example, if the Registry contains .\Captions\Session whose value is:
My APL ({WSID}) Version {VER_A}.{VER_B}[{VER_C}] - {PID}
then the caption displayed in a new Dyalog APL Session window might be:
My APL (CLEAR WS) Version 14.0[20105] - 4616